Carregar Regras de Merchandising Avançado em Formato JSON

Esta secção contém instruções e detalhes sobre como adicionar regras de outras fontes ao Merchandising Avançado através do carregamento de ficheiros. O objetivo é evitar trabalho duplicado e reduzir o esforço necessário para criar no Merchandising Avançado regras que já existam noutro sistema. Pode carregar valores de contexto de produto, atributo e categoria em formato JSON para regras de merchandising avançado. Os campos obrigatórios na interface de criação de regras também são obrigatórios no ficheiro carregado, enquanto todos os restantes campos são opcionais. Além disso, pode combinar e carregar um grupo de IDs de produto para um contexto ou recomendação numa nova regra. A funcionalidade Carregar Regras foi concebida para criar novas regras e não atualiza regras existentes.

Carregar Regras

  1. Certifique-se de que o ficheiro que pretende carregar está disponível no seu computador e se encontra em formato JSON.

    2. Exemplo de formato de ficheiro: https://richrelevance.egnyte.com/dl/PAugqrGA3r

  2. No dashboard Personalization Platform, aceda a Recomendações > Merchandising Avançado. A página Merchandising Avançado é apresentada com as regras já criadas. 

  1. Clique em + Carregar Regras.

    Será aberta uma janela para selecionar ficheiros.

  1. Localize o ficheiro que pretende carregar, selecione-o e clique em Abrir.

    • Se o carregamento for bem-sucedido, as suas regras serão guardadas e listadas na página de regras de Merchandising Avançado para revisão. As regras ficam ativas em produção após o carregamento.

    • Se o carregamento não for bem-sucedido, será apresentada uma caixa de erro vermelha no canto superior direito a indicar que ocorreu um erro.

    • Se uma regra carregada fizer referência a algo que não existe, essa regra simplesmente não devolverá resultados.

    • Se ocorrer um erro numa regra de um ficheiro em lote, todo o ficheiro será revertido.

Diretrizes do Ficheiro de Carregamento

  • Formato: json

  • Como deve o ficheiro estar estruturado? Consulte Exemplo de JSON.

  • Limitações:

    • Cada regra pode ter no máximo 100 grupos de IDs de produto carregados.

    • Podem ser carregadas no máximo 1500 regras com três grupos cada.

  • O que pode ser carregado?

    • Valores de contexto possíveis

      • Produtos, Atributos, Categorias

  • Os campos obrigatórios no Merchandising Avançado também são obrigatórios no ficheiro carregado. Todos os outros campos são opcionais.

  • Pode ser carregado um grupo de IDs de produto para um contexto ou grupo de recomendação numa regra específica? Isto é possível apenas para novas regras. A atualização de uma regra através de ficheiro carregado não é suportada.

  • Ficheiros de mapeamento de compatibilidade não são atualmente suportados na funcionalidade Carregar Regras.

  • Convenções de nomenclatura:

    • Se uma regra tiver um nome e for criada uma segunda regra com o mesmo nome, será possível guardá-la. Não existem restrições para regras com o mesmo nome.

Exemplo de JSON

Copy 
[{
"name":"Rule Bundle Test L001",
"importance":1,
"message":"Tilbehør",
"placements":[
"Item page.recs_accessories"
],
"startDate":"2017-07-16T19:20:30",
"endDate":"2018-10-12T21:20",
"context":{
"type":"CATEGORY",
"values":[
"21415"
]
},
"recommendedGroups":[
{
"name":"TestGroup1",
"itemsNumber":2,
"items":{
"type":"PRODUCT",
"values":[
"867712",
"954621",
"831179"
]
}
}, {
"name":"TestGroup2",
"itemsNumber":3,
"items":{
"type":"ATTR_MERCHANT",
"name":"MARGIN",
"values":[
"5.37",
"5.35"
]
}
}, {
"name":"TestGroup3",
"itemsNumber":5,
"items":{
"type":"TEMPLATE",
"name":"appleacc"
}
}
]
}, {
"name":"Rule Bundle Test L002",
"importance":1,
"message":"Tilbehør",
"placements":[
"Item page.recs_accessories"
],
"startDate":"2017-07-16T19:20:30",
"endDate":"2018-10-12T21:20",
"context":{
"type":"CATEGORY",
"values":[
"21415"
]
},
"recommendedGroups":[
{
"name":"TestGroup1",
"itemsNumber":2,
"items":{
"type":"PRODUCT",
"values":[
"867712",
"954621",
"831179"
]
}
}, {
"name":"TestGroup2",
"itemsNumber":3,
"items":{
"type":"ATTR_MERCHANT",
"name":"MARGIN",
"values":[
"5.37",
"5.35"
]
}
}, {
"name":"TestGroup3",
"itemsNumber":5,
"items":{
"type":"TEMPLATE",
"name":"appleacc"
}
}
]
}, {
"name":"Rule Bundle Test L003",
"importance":1,
"message":"Tilbehør",
"placements":[
"Item page.recs_accessories"
],
"startDate":"2017-07-16T19:20:30",
"endDate":"2018-10-12T21:20",
"context":{
"type":"CATEGORY",
"values":[
"21415"
]
},
"recommendedGroups":[
{
"name":"TestGroup1",
"itemsNumber":2,
"items":{
"type":"PRODUCT",
"values":[
"867712",
"954621",
"831179"
]
}
}, {
"name":"TestGroup2",
"itemsNumber":3,
"items":{
"type":"ATTR_MERCHANT",
"name":"MARGIN",
"values":[
"5.37",
"5.35"
]
}
}, {
"name":"TestGroup3",
"itemsNumber":5,
"items":{
"type":"TEMPLATE",
"name":"appleacc"
}
}
]
}]

Dicas Adicionais

  • Se uma regra carregada fizer referência a algo que não existe (por exemplo, uma categoria que não está no feed), essa regra simplesmente não devolverá resultados.
  • Se um ficheiro em lote incluir uma regra com erro, todo o lote será rejeitado/revertido.
  • Quando as regras são carregadas, ficam ativas em produção.